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USER’S  MANUAL  for  Relocatable  Modeling  Environment, 

Version  1.0 


1.0  INTRODUCTION 

1.1  Scope 

1.1.1  Identification 

Version  1.0  (22  February  1998) 

ONR  Research  Grant  No:  N000 1 4-95- 1  -0203 

Contractor:  Mississippi  State  University 

Center  for  Air  Sea  Technology 
Building  1103,  Room  233 
Stennis  Space  Center,  MS  39529-6000 
Telephone:  (228)  688-4218 
Facsimile:  (228)  688-7100 


1.1.2  Background 


The  many  steps  and  logistics  of  setting-up  a  numerical  model  in  a  new  region 
of  interest  are  tedious  and  labor  intensive.  Much  of  this  effort  can  be  simplified  with 
modem  computer  technology.  For  example,  in  setting-up  a  2-D  tidal  model,  one 
needs  to  specify  the  domain,  define  the  model  grid  of  a  specified  resolution,  select 
the  appropriate  bathymetry  database  and  extract  the  data,  edit  the  bathymetry  for 
errors  such  as  opening-up  closed  channels,  select  and  extract  ancillary  data  such  as 
the  International  Hydrographic  Office  (IHO)  tidal  station  data,  make  sure  the  stations 
fall  on  a  grid  point  over  water  instead  of  land,  edit  the  ancillary  data  to  correct  errors, 
define  the  model  boundaries,  specify  the  model  boundary  conditions,  generate  the 
model  header  files,  and  generate  the  model  input  and  initialization  files. 

All  of  these  steps  need  to  be  completed  before  the  model  can  be  run  to  obtain 
the  first  output.  This  process  can  consume  anywhere  from  a  couple  of  days  to  a 
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couple  of  weeks  depending  on  the  complexity  of  the  domain  and  data.  For  more 
complex,  3-D,  data  assimilating  circulation  models,  there  are  also  other  steps.  The 
user  is  also  faced  with  postprocessing  the  model  output  and  managing  it 
systematically. 

Under  ONR  funding,  the  University  of  Colorado  has  developed  the 
CURReNTSS  (Colorado  University’s  Rapidly  Relocatable  Nestable  Tides  and  Storm 
Surge)  Model,  which  is  currently  a  2-D  tidal  model.  The  Mississippi  State 
University  Center  for  Air  Sea  Technology  (MSU-CAST)  has  embedded  the  model  in 
a  Relocatable  Modeling  Environment  (RME),  that  provides  a  user  friendly, 
interactive  graphical  user  interface  (GUI)  which  allows  for  quick  relocation  of  the 
model  to  any  oceanic  region  for  which  databases  and  forcing  fields  exist.  This  report 
provides  a  user’s  manual  for  this  system.  This  system  includes  the  following 
modules: 

Grid  Generation:  The  GUI  produces  a  world  map  for  selecting  the  region  to  be 
modeled.  The  user  specifies  a  uniform  grid  spacing  and  two  diagonal  points  on  the 
model  domain  boundary,  and  the  GUI  automatically  generates  the  ‘rectangular’  grid 
(actually,  grid  lengths  DX  =  DY  are  specified  in  degrees,  and  only  for  small  domains 
is  the  grid  approximately  rectangular).  Similarly,  the  nested  grid  is  embedded  in  the 
coarse  domain.  The  GUI  automatically  creates  four  files  needed  for  model 
initialization: 

(1)  (Longitude,  Latitude)  for  each  grid  point  in  the  coarse  grid 

(2)  (Longitude,  Latitude)  for  each  grid  point  in  the  fine  grid 

(3)  Interpolated  bathymetry  for  the  coarse  grid 

(4)  Interpolated  bathymetry  for  the  fine  grid. 

In  addition,  the  GUI  creates  a  file  of  tidal  constituents  from  tide  gauge  stations 
located  in  the  model  domain,  extracted  from  the  IHO  database  (1979)  supplemented 
with  data  from  the  Admiralty  charts  (1993).  Data  for  each  tidal  constituent  from  the 
selected  stations  are  assimilated  into  the  model. 

Pre-Processing:  This  module  provides  an  interactive  capability  to  edit  the 
bathymetry  and  the  IHO  station  files.  The  bathymetry  editing  capability  allows  one 
to  open  or  close  channels  or  change  depths,  according  to  the  information  available  at 
the  time  of  model  execution.  Similarly,  editing  of  the  IHO  station  files  provides  the 
capability  to  de-select  stations  (for  data  assimilation),  if  so  required,  or  to  move  them 
spatially  (essentially  altering  their  locations). 
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Model  Packaging:  This  module  is  transparent  to  the  user  and  his  interaction  at  this 
stage  is  not  needed.  The  model  packaging  module  readies  data  files  for  porting  to  a 
remote  host  machine.  This  involves  converting  files  to  netCDF  followed  by  tarring 
of  all  source  code  files  and  data  files  necessary  for  successful  model  execution. 

Remote/Local  Execution:  This  module  offers  the  user  an  opportunity  to  modify  any 
of  the  input  parameters,  e.g.,  bottom  roughness,  model  integration  time-step,  etc. 
After  entering  the  URL  address  of  the  remote  machine,  the  model  package  is  ported 
to  it.  The  files  are  automatically  un-tarred,  the  source  code  compiled,  and  submitted 
to  the  machine  for  execution.  After  the  execution  is  complete,  the  saved  output  files 
are  automatically  tarred  and  imported  back  to  the  local  machine  for  post-processing, 
and  the  user  receives  the  message  of  run  completion  on  the  local  machine. 

Post-Processing:  This  module  provides  the  capability  of  preparing  graphics  from  the 
saved  model  output.  These  include  time-series  plots  at  selected  locations  of: 
vertically  integrated  currents  including  U,  V,  speed,  and  sea  surface  height;  snapshots 
of  tidal  current  vectors  with  overlying  contours  of  sea  surface  height  which  can  be 
used  for  preparing  animations  of  model  results;  tables  for  tidal  events  for  a  specified 
duration;  and  co-tidal  and  co-phase  plots  for  all  tidal  constituents. 

The  objective  of  the  RME  is  to  provide  an  interactive  capability  of  relocating 
the  CURReNTSS  model  to  any  region  of  the  world,  run  the  model  at  a  remote 
location  if  so  preferred,  and  visualize  the  model  results  in  selected  formats  which  can 
facilitate  interpretation  of  results.  The  main  objective  of  RME  is  to  provide  a  user- 
friendly,  interactive  GUI  for  an  end-to-end  implementation  of  the  model.  The 
implementation  is  achieved  using  the  Extensible  Distributed  Graphical  Environment 
(EDGE)  concept  developed  at  CAST.  This  version  is  tuned  to  CURReNTSS  but  can 
be  tailored  in  the  future  to  any  atmospheric/oceanic  model.  This  manual  documents 
procedures  of  the  RME. 

The  RME  provides  the  user  with  a  default  bathymetry  database  of  ET0P05 
but  can  incorporate  any  local/regional/global  bathymetry  database  in  the  longitude- 
latitude-bathymetry  format.  It  uses  the  global  tidal  station  database  for  assimilation. 
The  boundary  conditions  data  sets  from  the  Global  Model  Run  for  CURReNTSS  and 
the  Desai-Wahr  run  are  also  supplied  to  the  user. 
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1.2  Conventions 


To  simplify  and  standardize  the  communication  of  procedural  details  to  the 
user,  this  manual  adopts  the  following  conventions: 

Mouse  Button  Convention:  ‘Click’  or  ‘select’  operations  with  the  mouse  are  to  be 
done  with  the  left  button  unless  otherwise  specified. 

Dragging  the  Mouse:  ‘Drag’  operations  are  done  by  depressing  the  middle  button 
unless  otherwise  specified,  moving  it  to  the  desired  spot,  and  then  releasing  it. 

Rubber-banding:  This  process  involves  depressing  the  left  mouse  button  and 
moving  the  cursor  from  the  top  left  comer  of  the  region  of  interest  on  a  picture/map 
to  the  bottom  right  comer  (while  keeping  it  pressed),  and  then  releasing  the  left 
mouse  button.  This  procedure  forms  a  rectangular  border,  which  is  usually  used  to 
specify  a  region  for  zooming  and  other  functions. 

1.3  Referenced  Documents 


1.3.1  Mehra,  Avichal,  Ranjit  Passi,  Lakshmi  Kantha,  Steven  Payne,  and  Shuvobroto 
Brahmachari  -  “Barotropic  Tidal  Predictions  and  Validation  in  a  Relocatable 
Modeling  Environment”  -  MSU  CAST  Technical  Report,  l-98(Revised),  20  May 
1998,  20pp. 


2.0  EXECUTION  PROCEDURES 


2.1  Initialization  (Launching  the  Application) 

RME  observes  the  standard  procedure  for  executing  an  application  in  the 
UNIX/X-Windows  environment.  After  specifying  pathnames  and  environment 
variables  in  the  ‘.cshrc’  or  ‘.login’  files,  the  user  enters  ‘rme2d’  at  the  UNIX 
command  line  prompt. 

This  starts  up  the  EDGE  environment  to  run  the  RME  modules.  When  X- 
Windows  initialization  procedures  are  complete,  the  RME  GUI  initial  window 
appears  (Figure  1).  The  icons  displayed  represent  the  three  categories  of  models  that 
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RME  can  incorporate  in  future  versions.  Double  clicking  on  the  ‘Tidal  Models’  icon 
brings  up  the  icons  representing  tidal  models  (Figure  2). 
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Figure  1  -  RME  initial  window 


Figure  2  -  RME  Tidal  Model  window 

Since  RME  currently  incorporates  only  the  CURReNTSS  model,  this  is  the  only  icon 
displayed  here.  Double  clicking  on  it  will  bring  up  a  page  containing  icons 
representing  RME  processes  and  databases  (Figure  3).  This  is  the  main  ‘RME 
procedures  page’  and  is  the  central  console  for  all  RME  operations. 


Figure  3  -  RME  main  window 


2.2  Description  of  Modules 

Six  procedure  modules  can  be  seen  in  Figure  3,  as  green  icons  in  the  upper 
row.  The  two  pink  icons  represent  the  database  managers,  which  organize  data  into 
easily  operable  visual  packets.  The  processes  are  described  in  detail  below. 

2.2.1  Grid  Generator 

The  steps  required  to  run  the  Grid  Generator  module  for  RME: 

1.  Double  click  on  the  Grid  Generator  icon  to  produce  the  Grid  Generator  GUI 
(Figure  4).  This  has  a  world  map  for  selecting  the  region  of  interest. 
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Figure  4  -  Grid  Generator  GUI 
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2.  a.  Either  rubber-band  the  region  or  specify  the  minimum  and  maximum  latitudes 
and  longitudes  in  the  region  coordinates  textbox,  and  hit  enter.  The  permissible 
range  for  latitudes  is  —90  to  90  and  that  of  longitudes  is  —180  to  180. 

b.  Alternatively  select  a  region  from  the  ‘Defined  Grids’  box  which  displays 
previously  defined  grids  stored  in  the  database. 

3.  A  white-bordered  region  of  interest  is  created  and  displayed  (see  Figure  4). 

4.  Use  the  ‘zoom’  button  to  zoom  in  for  final  region  selection  or  for  nesting  a  grid 
(see  Figure  5). 

5.  Using  the  ‘unzoom’  button  returns  to  the  previously  selected  grid,  or  to  the  world 
map  if  no  grid  has  been  selected  before.  The  ‘Lat’  and  ‘Lon’  boxes  provided  next 
to  the  ‘zoom’  and  ‘unzoom’  buttons  indicate  the  position  of  the  cursor  which  is 
displayed  as  a  cross  in  the  map  area. 

6.  Specify  the  model  grid  resolution  in  the  ‘X  and  Y  resolution’  boxes  in  degrees. 

7.  Select  a  bathymetry  from  the  ‘Defined  Bathymetries’  box.  The  ET0P05  is 
supplied  with  RME,  and  the  user  can  append  any  regional/global  bathymetry  of 
preference  to  the  database  provided  they  are  in  an  acceptable  format  (see 
Appendix  C). 

8.  Select  an  IHO  station  database  for  the  ‘Defined  Stations’  box. 

9.  Save  the  region  by  clicking  on  ‘Region’  in  the  overhead  pull-down  menu  and  then 
clicking  on  ‘save’. 

10. This  pops  up  the  ‘Add  Region  Dialog’  window  (Figure  6)  which  has  a  box  for  the 
region  name. 

11.  Enter  a  name  of  choice  for  the  region  and  click  on  the  ‘Add’  button,  which  will 
initiate  the  saving  process. 
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Figure  6  -  The  ‘Add  Region  Dialog’  window 


The  bathymetry  file  selected  is  interpolated  and  mapped  on  to  the  grid  and  the 
regional  station  data  is  extracted  from  the  global  database  for  future  editing  in  the 
‘Pre-Processor’  module.  After  the  saving  process  is  complete,  the  saved  region  name 
appears  in  ‘Defined  Grids’  box.  If  the  user  chooses  to  nest  a  grid,  the  following  steps 
must  be  taken: 

1.  Click  on  previously  selected  region  from  the  ‘Defined  Grids’  box. 

2.  Click  on  ‘Region’  on  the  pull-down  menu  and  then  click  on  the  ‘Nested’  toggle 
button. 

3.  A  region  of  choice  can  either  be  rubber-banded,  or  the  coordinates  of  the  nested 
grid  can  be  entered  in  the  ‘Region  Coordinates’  box  as  before. 

4.  Instead  of  filling  in  the  grid  resolution,  select  a  ratio  to  the  original  grid  from  the 
Nested  Resolution  box. 

5.  The  nested  region  can  be  saved  in  a  similar  manner  to  the  regular  region. 


It  should  be  noted  that  the  saving  process  can  take  up  to  several  minutes 
depending  on  the  size  and  resolution  of  the  grid  as  extraction  and  interpolation  is 
carried  out  during  the  saving  process.  The  user  must  wait  for  the  ‘Add  Region 
Dialog’  window  to  disappear  for  confirmation  of  file  saving. 
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2.2.1.1  Menu  Bar 


The  Grid  Generator  Module  contains  a  menu  bar  consisting  of  four  pull-down 
menus.  These  interactive  menu  headers  are  labeled  ‘File’,  ‘Region’,  ‘Overlay’  and 
‘Help’. 


2.2.1. 1.1  File  Pull-down  Menu 

The  options  available  from  the  ‘File’  pull-down  menu  are  ‘ReDraw’,  ‘Iconify’, 
and  ‘Quit’  (Figure  7).  There  are  keyboard  shortcuts  available  for  these  menu  options 
and  these  are  noted  alongside  the  names. 

ReDraw  -  The  ‘ReDraw’  option  deletes  the  image  in  the  Map  section  and  draws  it 
again  to  remove  any  distortions  that  may  have  been  caused  by  other 
applications. 

Iconify  -  The  ‘Iconify’  button  reduces  the  Grid  Generator  GUI  to  an  icon,  which 
can  be  retrieved  by  clicking  on  it. 

Quit  -  The  ‘Quit’  button  stops  the  ‘Grid  Generator’  process.  The  user  must 
note  that  all  unsaved  regions  will  be  lost  if  this  option  is  used.  The  GUI 
does  not  prompt  the  user  to  save  if  the  ‘Quit’  button  is  pressed.  These 
options  are  similar  to  the  ones  in  the  other  modules  as  well. 


Figure  7  -  The  ‘File’  pull-down  menu  for  the  Grid  Generator 
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2. 2. 1.1. 2  Region  Pull-down  Menu 


The  options  available  from  the  ‘Region’  pull-down  menu  are  ‘Delete’,  ‘Nest’, 

‘Reset’  and  ‘Save’.  The  ‘Nest’  and  the  ‘Save’  button  functions  have  already  been 

discussed  in  the  previous  section. 

Delete  -  To  delete  a  saved  region,  the  user  selects  the  desired  region  in  the 
‘Defined  Grids’  box  and  presses  the  ‘Delete’  button  which  removes  the 
selected  database. 

Nest  -  The  ‘Nest’  button  is  a  toggle  button,  which  can  be  turned  on  or  off 
depending  on  the  user’s  preference  of  the  type  of  grid.  However,  a 
warning  is  posted  in  the  ‘Remark’  box  if  the  user  tries  to  save  a  nested 
region  without  defining  a  regular  grid  first. 

Save  -  The  ‘Save’  button  prompts  the  user  to  save  a  particular  region  that  has 
been  selected. 

Reset  -  The  ‘Reset’  button,  removes  all  unsaved  region  selection  and  redraws 
the  world  map. 


2.2.1.1.3  Overlay  Pull-down  Menu 

The  ‘Overlay’  header  in  this  module  provides  the  user  with  only  the  option  of 
overlaying  labels  on  the  Map.  Clicking  on  the  ‘Labels’  button  pops  up  the  ‘Labels 
and  Arrows’  window  (Figure  8)  which  has  specifications  of  the  type  of  label  the  user 
might  want  displayed  in  the  map.  The  features  of  the  window  are  listed  below: 

•  The  ‘Arrow  On/Off’  radio  button  attaches  an  arrow  to  the  text  for  labeling 
purposes. 

•  The  arrow  length,  width  and  head  length  can  be  specified  by  dragging  the  sliders 
using  the  left  mouse  button. 

•  The  ‘Angle’  box  is  for  specifying  the  angle  of  the  text  to  appear  in  degrees. 

•  The  ‘Label  Text’  box  can  be  used  by  the  reader  to  put  in  the  text  for  the  label. 

•  The  ‘Clear  Entries’  button  clears  the  entries  made  in  the  ‘Angle’  and  ‘Label  Text’ 
boxes. 

•  A  choice  of  fonts  for  the  label  text  is  provided  in  the  ‘Text  Font’  box. 
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•  The  label  text  can  also  be  justified  using  choices  in  the  ‘Text  Justification’  box. 

•  The  text  size  can  be  altered  by  using  the  ‘Text  Size’  slider  bar. 

•  The  color  can  be  changed  by  clicking  on  the  color  box. 

•  The  ‘Dismiss’  button  removes  the  ‘Labels  and  Arrows’  window. 

•  The  ‘Erase  Last’  button  removes  the  last  label  created. 

•  The  ‘Erase  All’  button  deletes  all  labels  created. 

•  To  overlay  the  label  on  the  image,  the  user  clicks  on  the  map  with  the  right  mouse 
button. 


Figure  8  -  The  Overlay  Labels  ‘Labels  and  Arrows’  window 
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2.2.2  Pre-Processor 


After  saving  and  quitting  the  ‘Grid  Generator’  module,  the  database  created  is 
now  ready  to  be  edited  using  the  ‘Pre-Processor’.  An  icon  in  the  ‘Database 
Manager’  represents  the  database  created.  To  run  the  Pre-Processor  complete  the 
following  steps: 

1.  Open  the  ‘Database  Manager’  by  double  clicking  on  the  icon  representing  it  in  the 
‘RME  procedures  page’  (see  Figure  3). 

2.  This  pops  up  another  EDGE  page  containing  five  database  icons,  ‘Bathy-Coarse’, 
‘Bathy-Fine’,  ‘Model  Forcing’,  ‘Model  Res-Coarse’  and  ‘Model  Res-Fine’ 
(Figure  9).  This  is  the  ‘RME  Data  Page’  which  is  used  to  manage  all  the 
databases  related  to  RME. 

3.  Double-click  on  the  ‘Bathy-Coarse’  icon  to  open  the  Regular  Grid  database. 

4.  This  generates  a  page  containing  icons  representative  of  saved  databases,  which 
contain  gridded  bathymetry  and  station  data  (Figure  10).  Clicking  on  other 
databases  icons  will  generate  similar  pages. 

5.  Drag  the  selected  database  icon  to  the  ‘Pre-Processor’  icon  in  the  ‘RME 
procedures  page’  to  activate  the  ‘Pre-Processor’  module.  To  facilitate  this  process 
place  the  two  EDGE  windows  (Figure  3  and  10)  on  top  of  each  other. 

6.  This  pops  up  the  ‘Pre-Processor’  window  (Figure  11)  which  has  features  to  edit 
bathymetry,  stations  and  define  boundary  conditions. 

To  discuss  the  individual  features,  it  is  necessary  to  explain  the  features  of  the 
menu  bar.  The  other  features  of  the  ‘Pre-Processor’  window  are  the  ‘Zoom’  and  the 
‘Unzoom’  buttons,  and  the  ‘Lat’  and  ‘Lon’  text  boxes  which  were  discussed  in  the 
Grid  Generator  module  (see  Section  2.2.1).  The  ‘Bathy’  box  displays  the  bathymetry 
of  the  grid  point  nearest  to  the  location  of  the  cursor. 


2.2.2. 1  Menu  Bar 

The  Menu  Bar  in  the  Pre-Processor  consists  of  four  interactive  menu  headers 
labeled  ‘File’,  ‘Edit’,  ‘Options’  and  ‘Overlay’  (Figure  11). 
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Figure  9  -  The  Database  Manager  EDGE  window 


j  |  [  Q  I  in  \ 

bank"..  S  ••  I  Reload  .|  stop  |  ;  5lfif  |  S 


Location;  e(ig«://IR!S3xast.nisslatn.witi/grauptehiiva_ritj/rwjMmjfii_CHarse.o(3r 


Utilities 


Go 


Controls 

}0KO9Me9Kti*MMM0MM4CCp46Ctt^<^^ 


Help 


X'  CSi. 

mmm m*  •  •  ■ 


!  v»%\  \%%  \  \ 


2yet51x71  DATA 


Figure  10  -  The  Bathy-Coarse  EDGE  window 


2.2.2.1.1  File  Pull-down  Menu 


The  options  available  in  the  ‘File’  pull  down  menu  are  ‘Save’,  ‘ReDraw’, 
‘Reset  Area’,  ‘Iconify’  and  ‘Quit’  (Figure  12). 


Figure  12  -  The  File  pull-down  menu  for  the  Pre-Processor 

Save  -  This  button  features  its  own  pull-down  menu  with  options  of 
components  to  save.  Choosing  ‘Image’  saves  the  current  image  to  a  file. 
Choosing  ‘Bathymetry’  saves  the  edited  bathymetry  stored  in  the  buffer 
to  the  database.  Choosing  ‘Stations  &  Points’  not  only  saves  the  edited 
stations  but  also  saves  locations  in  the  grid  to  be  used  by  the  model  to 
generate  time-series  files.  The  ‘Boundary  Conditions’  button  saves 
boundary  conditions  to  be  used  by  the  model  to  the  database. 

ReDraw  -  This  option  redraws  the  base  bathymetry  contours  with  all  the  overlaid 
images. 

Iconify  -  The  ‘Iconify’  button  reduces  the  Pre-Processor  GUI  to  an  icon,  which 
can  be  retrieved  by  clicking. 

Quit  -  The  ‘Quit’  button  quits  the  ‘Pre-Processor’  process.  The  user  must  note 
that  all  unsaved  changes  to  the  edited  bathymetry,  stations,  and 
boundary  condition  will  be  lost  if  this  option  is  used.  The  GUI  does  not 
prompt  the  user  to  save  if  the  ‘Quit’  button  is  pressed.  These  options  are 
common  to  the  other  modules  as  well. 


2.2.2.1.2  Edit  Pull-down  Menu 

The  ‘Edit’  pull-down  menu  has  the  options  ‘Bathymetry’,  ‘Stations’  and 
‘Boundary  Conditions’  (Figure  13)  which  generate  windows  to  edit  the  respective 
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fields.  The  editing  functions  are  exclusive  of  each  other  and  cannot  be  carried  out 
simultaneously.  The  editing  functions  are  discussed  in  detail  in  the  section  2.22.2. 


Figure  13  -  The  Edit  pull-down  menu  for  the  Pre-Processor 


2. 2. 2. 1.3  Options  Pull-down  Menu 

The  ‘Options’  pull-down  Menu  has  five  option  buttons:  ‘Plot  Types’, 

‘Colormap’,  ‘Palette  Orientation’,  ‘User  Draw  Options’,  and  ‘Plots  Draw  Options’. 

Plot  Types  -  This  button  itself  has  three  choices  of  plots.  Since  the 

bathymetry  plot  is  a  contour  plot,  only  the  ‘Color  Fill’ 
(Figure  11)  and  ‘Isoline’  (Figure  14)  are  applicable. 

Colormap  -  This  button  provides  the  choice  of  a  ‘Default’, 

‘Interpolated’  or  a  ‘Custom  made’  colormap  for  the  contour 
plots. 

Palette  Orientation  -  This  button  gives  the  choice  of  horizontal  or  vertical  palette 

orientation. 

User  Draw  Options  -  This  pops  up  a  ‘User  Draw  Dialog’  window  (Figure  15) 

which  gives  the  choice  of  changing  markers,  and  coastline 
line  size  and  color.  It  also  provides  the  user  with  a 
minimum  water  value  for  the  water  mask  used  during 
masking,  a  feature  used  to  facilitate  bathymetry  editing. 


Plot  Draw  Options  -  This  button  pops  up  an  ‘Editing  Dialog’  window  (Figure 

16)  which  permits  changes  to  Isoline  type  and  width.  The 
minimum  value  of  the  data  point  (in  this  case  bathymetry) 
to  be  plotted  and  contouring  interval  can  also  be  set. 
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Figure  14  -  The  Options  pull-down  menu  in  the  Pre-Processor 


Figure  15  -  The  User  Draw  Dialog  window 
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Figure  16  -  The  Editing  Dialog  window 


2.2.2.1.4  Overlay  Pull-down  Menu 


The  Overlay  pull-down  menu  features  five  option  buttons,  ‘Station  Data’, 
‘Labels’,  ‘Coastline’,  ‘Grid’,  and  ‘Mask’. 

Station  Data-  Overlaying  the  station  data  displays  the  stations  available  for 
assimilation  during  the  model  run  in  this  domain  (Figure  17).  The 
stations  on  land  and  sea  are  represented  by  different  icons. 
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Figure  17  -  Overlaying  stations  in  the  Pre-Processing  GUI 


Labels  - 


Overlaying  labels  is  identical  to  the  procedure  in  the 
Generator  module  (see  Section  2.2. 1.1. 3). 


Coastline  - 


Coastline  from  several  available  resolutions  can  be  overlaid  from 
the  RME  database  to  facilitate  editing  (Figure  18). 


Grid- 


Figure  18  -  Overlaying  coastline  in  the  Pre-Processor  GUI 

The  user  has  the  option  of  overlaying  the  model  grid,  user  defined 
grid,  or  both  (Figure  19).  Choosing  the  ‘Model  Grid’  option 
displays  the  model  grid  in  red  dots  for  water  points  and  blue  dots 
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for  land  points.  The  nested  grid  is  also  displayed  if  one  is 
available.  Choosing  the  ‘User  Grid’  pops  up  a  ‘User  Grid  Dialog’ 
window,  which  prompts  the  user  to  include  grid  spacing  in  a  box. 


Figure  19  -  Overlaying  grid  in  the  Pre-Processor  GUI 
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Mask  -  This  feature  provides  the  user  with  the  choice  of  either  masking 

land  or  water  in  bathymetry  contour  plot  to  assist  in  editing 
bathymetry. 

2.22.2  Editing  Features 

The  three  editing  processes  featured  in  the  ‘Pre-Processor’  are  ‘Bathymetry’, 
‘ Station ’ ,  and  ‘Boundary  Condition ’ . 

2. 2. 2.2.1  Bathymetry  Editing 

This  feature  is  activated  by  the  ‘Bathymetry’  option  of  the  ‘Edit’  pull  down 
menu.  When  activated,  it  pops  up  a  ‘Bathy  Edit  Dialog’  window  (Figure  20)  which 
has  four  radio  buttons  for  choosing  editing  options.  To  edit  bathymetry,  the 
following  steps  are  taken: 

1.  Click  on  the  ‘Edit’  pull-down  menu  and  then  on  the  ‘Bathymetry’  button. 

2.  Overlay  coastline  by  clicking  the  ‘Overlay’  button  on  the  pull-down  menu, 
clicking  ‘Coastline’  and  then  choosing  a  coastline  resolution. 

3.  Overlay  Model  Grid  by  clicking  the  ‘Overlay’  button  on  the  pull-down  menu, 
clicking  ‘Grid’  and  then  clicking  on  the  ‘Model  Grid’  button. 

4.  If  preferred,  overlay  land  or  water  masking  by  clicking  on  the  ‘Overlay’  pull¬ 
down  menu  again,  clicking  on  ‘Mask’  and  choose  the  appropriate  masking. 

5.  To  edit  a  point,  click  on  the  ‘Edit  Point’  radio  button  in  the  ‘Bathy  Edit  Dialog’ 
window. 

6.  Set  the  appropriate  conversion  value  in  ‘Enter  new  value’  box. 

7.  Click  on  any  grid  point  with  the  middle  mouse  button  and  convert  it  from  land  to 
water,  or  water  to  land,  depending  upon  the  relevant  selection  in  the  ‘Bathy  Edit 
Dialog’  window.  While  converting  from  water  to  land,  when  the  points  are 
clicked  on  by  the  middle  mouse  button,  they  are  marked  by  blue  crosses. 
Similarly  they  are  marked  with  pink  crosses  when  converting  from  land  to  water. 

8.  To  edit  a  group  of  points  select  the  ‘Edit  Group’  option  in  the  ‘Bathy  Edit  Dialog’ 
window. 
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9.  Click  on  several  places  on  the  plot  with  the  middle  mouse  button  creating  yellow 
crosses,  which  are  used  as  zone  markers  (see  Figure  20). 

lO.Once  the  zone  has  been  marked,  the  user  can  click  anywhere  within  it  with  the 
right  mouse  button.  This  will  mark  all  relevant  grid  points  with  pink  (land  points 
if  ‘Land  to  Water’  is  selected)  or  blue  crosses  (water  points  if  ‘Water  to  Land’  is 
selected). 


Figure  20  -  Bathymetry  editing  in  the  Pre-Processor  GUI 
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11. Display  the  changes  in  contours  using  the  ‘ReDraw’  option  from  the  ‘File’  pull¬ 
down  menu. 

12.Save  the  edited  bathymetry  using  the  ‘bathymetry’  button  in  the  ‘File/Save’  pull¬ 
down  menus.  Failing  to  do  so  will  result  in  the  loss  of  all  the  edited  bathymetry. 
No  warning  to  save  is  given  if  the  user  decides  to  quit  the  ‘Pre-Processor’  without 
saving. 


2.2.22.2  Station  Editing 

To  edit  the  station  data  the  following  steps  are  followed: 

1.  Overlay  the  stations  by  clicking  on  the  ‘Overlay’  pull-down  menu  and  then 
clicking  on  ‘Stations’. 

2.  Activate  the  station  editor  by  clicking  on  the  ‘Stations’  button  in  the  ‘Edit’  pull 
down  menu.  This  pops  up  the  ‘Station  Edit  Dialog’  window  (Figure  21)  which 
contains  four  radio  buttons  and  eight  arrow  buttons. 

3.  Clicking  on  a  station  icon  will  select  the  station  for  editing  and  display  its  index, 
name,  and  position  in  the  ‘Station  Edit  Dialog’  box. 

4.  Clicking  on  the  station  icon  (while  pressing  the  shift  key)  will  display  more 
information  on  the  station,  such  as  component  names,  amplitudes,  and  phases. 
Another  ‘Station  Edit  Dialog’  window  pops-up  with  the  relevant  station 
information  (Figure  21).  These  can  be  altered  by  the  user  by  entering  different 
values. 

5.  Select  the  appropriate  radio  button  from  the  ‘Station  Edit  Dialog’  box. 
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6.  Once  a  station  has  been  selected,  it  can  be  moved  by  using  the  arrow  buttons,  or 
alternatively,  the  station  icon  can  be  dragged  with  the  middle  mouse  button  to  a 
different  location. 


7.  Stations  can  be  deleted  by  selecting  the  option  and  clicking  on  the  station  icon. 
The  appropriate  radio  button  must  be  selected  by  the  user  to  do  these  actions. 
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Figure  21  -  Station  editing  in  the  Pre-Processor  GUI 


8.  To  make  the  deleted  station  icons  disappear,  use  the  redraw  feature  of  the  ‘File’ 
pull-down  menu. 

9.  Save  time-series  locations  by  clicking  on  or  near  a  grid-point  which  pops  up  a 
‘Point  info  dialog’  window  (Figure  22).  Click  on  the  ‘store’  button. 

lO.Save  the  edited  station  data  and  time-series  locations  by  clicking  on  the  ‘File’ 
pull-down  menu,  clicking  on  the  ‘save’  button  and  then  clicking  on  the  ‘Stations 
&  Locations’  button.  All  edited  data  will  be  lost  on  failure  to  save  before  quitting 
preprocessing. 


Figure  22  -  Point  info  Dialog  window  of  the  Pre-Processor 


2.2.2.23  Boundary  Condition  Editing 

This  feature  is  used  to  initialize  the  boundary  conditions,  which  is  mandatory 
before  a  model  run.  To  edit  the  boundary  conditions,  the  following  steps  must  be 
followed: 

1.  Activate  the  boundary  conditions  editor  by  clicking  on  the  ‘Boundary  Conditions’ 
button  in  the  ‘Edit’  pull  down  menu.  The  ‘Boundary  Condition  Edit  Dialog’  pops 
up  (Figure  23).  This  is  used  to  mark  the  boundary  conditions  using  the  direction 
slider  bars  and  appropriate  data. 

2.  Using  the  radio  buttons  in  the  ‘Boundary  Condition  Edit  Dialog’  window,  select 
the  Open  Boundaries  for  which  conditions  need  to  be  initialized. 
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3.  Click  on  each  of  the  open  boundary  specification  button  sequentially. 

4.  Select  a  data  source  for  each  open  boundary  condition  after  clicking  on  the 
boundary  condition  selected. 

5.  Operate  the  slider  bars  to  set  up  the  boundary  extents  (see  Figure  23). 

6.  When  finished  with  each  operation,  click  ‘Next’  to  move  to  the  next  boundary  and 
repeat  steps  3  to  6. 

7.  When  all  boundary  conditions  have  been  initialized  click  on  ‘OK’  to  end  the 
editing  process. 

8.  Save  the  boundary  conditions  created  by  clicking  on  the  ‘File’  pull-down  menu, 
clicking  on  the  ‘save’  button  and  then  clicking  on  the  ‘Boundary  Conditions’ 
button.  As  with  bathymetry  and  station  editing,  the  boundary  conditions  must  be 
saved  before  quitting  the  ‘Pre-Processor’  module  or  all  changes  stored  in  the 
buffer  will  be  lost. 

9.  Once  all  necessary  changes  have  been  saved,  the  user  can  exit  ‘Pre-Processor’  by 
using  the  ‘Quit’  button  of  the  ‘File’  pull  down  menu. 

The  nested  grid  data  can  be  preprocessed  similarly  by  dragging  the  nested 
region  icon  to  the  ‘Pre-Processor.  The  nested  grid  icons  can  be  displayed  by  double¬ 
clicking  the  ‘Bathy-fine’  icon  under  the  ‘Database  Manager’.  While  bathymetry  and 
station  editing  are  permissible  for  the  nested  grid,  boundary  condition  editing  cannot 
be  carried  out  as  the  nested  grid  obtains  its  boundary  conditions  from  the  regular 
grid. 

2.2.3  Model  Packaging 

This  process  is  a  GUI-less,  non-interactive  process,  which  does  not  require 
user  input.  Once  the  user  is  finished  editing,  the  edited  database  can  be  packaged 
along  with  the  model  code,  in  preparation  for  remote  or  local  execution.  The 
packager  extracts  all  the  data  from  binary  netCDF  files  to  ASCII  in  the  formats  used 
by  the  CURReNTSS  model.  The  steps  to  run  the  packager  are: 

1.  Start  up  the  packager  and  drag  the  current  regular  database  icon  from  ‘Bathy- 
coarse’  group  of  the  ‘Database  Manager’  to  the  ‘Model  Packager’  icon.  The 
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nested  grid  icon  need  not  be  dragged  to  the  packager  as  it  automatically  packages 
the  nested  grid  files  if  a  nested  grid  exists. 

2.  Note  the  maximum  time  steps  permissible  for  both  the  regular  and  the  nested  grid 
which  pop  up  in  separate  windows  (Figure  24)  before  the  packager  quits.  The 
Courant-Friedrich-Lewy  (CFL)  condition  for  stability  is  applied  to  the  forcing 
data  to  check  for  the  maximum  permissible  time  step  that  can  be  used  during  the 
model  run. 


Figure  23  -  Boundary  Condition  editing  in  the  Pre-Processor 


30 


3.  Check  for  a  file  called  ‘model. tar’  in  the  home  directory.  After  going  through  the 
CFL  condition  test,  the  packager  tars  all  the  necessary  files  along  with  the  model 
code  in  a  file  called  ‘model.tar’  and  places  it  in  the  home  directory  of  the  user  for 
remote  or  local  execution. 


Figure  24  -  The  CFL  condition  pop-up  in  the  Model  Packager  module 

2.2.4  Remote  Execution 

This  module  is  required  when  the  user  wishes  to  run  the  model  remotely  in  a 
different  machine  than  the  one  running  RME.  The  user  may  prefer  to  do  this  to 
shorten  model  execution  time  which  can  take  several  hours.  ‘Remote  Execution’  can 
only  be  carried  out  after  the  model  has  been  packaged.  If  the  model  has  not  been 
packaged,  the  ‘Remote  Execution’  module  will  give  an  error  message  and  terminate. 
However,  if  a  previously  packaged  model  exists,  remote  execution  will  go  through 
model  execution  without  warning  the  user  and  return  the  results  to  the  current 
database.  This  will  result  in  erroneous  interpretations,  especially  if  the  domains  are 
of  the  same  size  and  the  error  goes  undetected.  Care  must  be  taken  to  ensure  that  the 
packager  is  executed  before  ‘Local/Remote  Execution’. 


2.2.4. 1  Operational  Features 

To  run  the  remote  execution  module,  the  following  steps  are  taken: 

1.  Drag  the  current  regular  database  icon  from  ‘Bathy-coarse’  of  the  ‘Database 
Manager’  to  the  ‘Remote  Execution’  icon  in  the  ‘RME  Procedures’  page  to  start 
remote  execution  (see  Figure  3).  The  nested  grid  icon  need  not  be  dragged  to  the 
packager  as  it  is  automatically  selected  for  execution  if  the  forcing  parameters  for 
the  nested  grid  have  been  packaged. 

2.  Once  the  ‘Remote  Execution’  process  starts,  the  ‘rem_exe’  window  pops  up 
(Figure  25). 
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3.  Fill  in  the  ‘remote  login’  parameters  in  the  ‘rem_exe’  window.  The  ‘Remote 
HostName’  text  box  requires  the  full  IP  address  or  pathname  of  the  remote  host, 
or  just  the  name  if  in  the  Local  Area  Network.  The  users  ‘Login  name’  and 
‘Password’  are  also  required  for  ‘ftp’  and  ‘telnet’  purposes. 

4.  Click  on  the  ‘OK’  button.  This  pops  up  the  model  runtime  parameter  window 
(Figure  26).  Runtime  parameters  can  be  altered  on  every  model  run  without 
having  to  preprocess  and  repackage  the  model. 


Figure  25  -  The  Login  dialog  pop-up  for  Remote  Execution  module 


5.  Fill  in  the  run  time  parameters  using  the  descriptions  given  in  Appendix  F. 

6.  Set  the  radio  buttons  for  the  various  astrodynamical  tidal  components  (M2,  S2, 
N2,  etc.). 

7.  Set  the  Radiation  Boundary  Radio  buttons. 

8.  Click  the  ‘Apply’  button  when  finished  with  the  runtime  parameter  window. 

9.  Click  on  the  ‘Exit’  button.  This  will  exit  the  window  and  set  the  values,  include 
them  in  the  appropriate  header  file  of  the  model,  and  add  it  to  the  model  package. 
This  also  initiates  the  rest  of  the  remote-execution  procedures  which  does  not 
require  input  and  pops  up  the  model  execution  status  window  (Figure  27). 

10.  Click  on  ‘Exit’  on  the  model  status  window  once  the  message  ‘Remote  Execution 
Complete’  is  displayed  on  the  model  execution  status  window.  This  could  take 
several  hours  depending  on  the  model  run  time  on  the  remote  machine. 
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Figure  26  -  The  Model  runtime  parameter  dialog  box  in  Remote/Local  Execution 


During  the  rest  of  the  remote  execution  process,  the  package  is  transferred  by  ‘ftp’ 
to  the  remote  machine,  the  ‘model.tar’  file  ‘untarred’  on  the  remote  machine,  the 
model  code  compiled  and  the  model  executed.  The  user  is  kept  informed  of  the 
model  execution  status  through  the  status  window,  which  monitors  all  ‘ftp’  and 
‘telnet’  sessions. 

After  the  model  run  for  the  regular  grid  has  been  completed,  the  boundary 
conditions  generated  for  the  nested  grid  are  transferred  to  the  appropriate  directory 
and  the  nested  model  is  compiled  and  executed.  Once  the  model  is  finished  running 
on  all  grids,  the  result  and  log  files  are  tarred  and  brought  back  to  the  local  machine 
by  'ftp'.  All  directories  created  in  the  remote  machine  are  deleted.  The  results  are 
converted  locally  to  netCDF  formats  to  be  stored  in  the  ‘results’  database  directory. 
The  netCDF  result  files  can  be  accessed  for  random  visualization  during  post¬ 
processing. 
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Figure  27  -  The  Model  execution  status  window  in  Remote/Local  Execution 


2.2.5  Local  Execution 

This  feature  is  to  be  used  only  if  the  user  intends  to  execute  the  model  locally 
on  the  machine  running  RME  instead  of  remotely  on  another  machine.  ‘Local 
Execution’,  like  ‘Remote  Execution’  can  only  be  done  after  packaging  has  been 
carried  out  on  the  selected  database.  All  precautions  specified  for  the  ‘Remote 
Execution’  module  also  apply  to  the  ‘Local  Execution’  module  (see  section  2.2.4). 

2.2.5.1  Operational  Features 

The  Local  Execution  Module  is  executed  similarly  to  Remote  Execution  (see 
section  2.2.4. 1).  The  steps  involved  are: 

1.  Drag  the  selected  database  icon  to  the  'Local  Execution'  icon  to  start  local 
execution.  This  starts  up  the  ‘Model  Parameter’  window  (Figure  26). 


2.  Edit  the  parameter  dialog  box  as  before. 

3.  Click  on  the  ‘apply’  button. 

4.  Click  on  the  ‘exit’  button.  This  brings  up  the  'status'  window  (Figure  27)  which 
prints  the  model  standard  outputs  and  keeps  the  user  informed  on  model  progress. 

5.  Once  the  model  execution  is  complete  click  on  the  ‘Exit’  button  on  the  model 
status  window  after  ‘Local  Execution  Completed’  is  displayed  there.  The  result 
files  are  converted  to  netCDF  formats  for  visualization  like  the  ‘Remote 
Execution’  module. 


2.2.6  Post- Processor 

This  module  has  been  designed  as  a  tool  for  result  visualization  and  data 
interpretation.  After  the  completion  of  remote  execution,  the  user  can  hit  the  'back' 
button  on  the  ‘RME  Data  Page’  (Figure  9).  See  section  2.2.2  for  details.  Once  the 
five  database  icons  are  visible,  the  user  can  click  on  either  the  'Res-Coarse'  icon  to 
view  the  regular  grid  results  database,  or  the  'Res-fine'  icon  to  view  the  nested  grid 
result  database.  Once  the  appropriate  database  is  displayed,  the  relevant  icon  can  be 
dragged  to  the  'Post-Processor'  icon  to  activate  the  process.  This  pops  up  a  window 
with  the  bathymetry  plotted  as  in  the  ‘Pre-Processor’  (Figure  28),  with  yellow 
asterisks  marking  the  saved  locations  for  time  series.  It  also  pops  up  a  ‘TimeSeries 
Dialog’  window  (Figure  28). 


2.2.6.1  Menu  Bar 

The  Menu  Bar  in  the  Post-Processor  consists  of  four  interactive  menu  headers 
labeled:  ‘File’,  ‘Graphics’,  ‘Options’  and  ‘Overlay’  (Figure  28).  The  pull  down  menu 
for  ‘File’,  ‘Options’  and  ‘Overlay’  are  identical  to  that  of  the  Pre-Processor  (see 
section  2.2.2. 1).  The  ‘Graphics’  header  replaces  the  ‘Edit’  header.  The  pull  down 
features  of  the  ‘Graphics’  interactive  header  are  discussed  in  the  next  section. 
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Figure  28  -  Time-series  dialog  window  in  the  Post-Processor  GUI 


2.2.6.2  Graphics  Features 

The  four  graphics  features  of  the  Post-Processor  are:  ‘Time  Series’,  ‘Co-tidal 
Analysis’,  ‘Snap  shots/Animation’,  and  ‘Tidal  Event  Log’. 
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2.2.6.2.1  Time  Series 


The  time-series  Dialog  window  is  the  default  displayed  when  running  the  Post- 
Processor.  It  can  also  be  displayed  by  clicking  the  appropriate  graphics  button.  The 
steps  involved  in  displaying  time-series  results  are: 

1.  Click  on  the  radio  buttons  to  select  the  parameters  for  which  time-series  is 
required  in  the  ‘Time  Series  Dialog  window  (Figure  28). 

2.  Select  the  time-span  of  the  time-series  plot  by  operating  the  slider  bar  in  the 
‘Time  Series  Dialog’  window. 

3.  Click  on  the  chosen  station  with  the  middle  mouse  button  to  display  the  time- 
series  at  a  particular  saved  location,  which  are  marked  with  yellow  asterisks.  This 
pops  up  a  time-series  window  (Figure  29)  which  displays  the  time-series  of  the 
selected  parameters.  If  no  time-series  location  has  been  saved,  a  blank  window 
appears  with  the  ‘no  time  series  file’  message  in  the  ‘Remark’  box  in  the  ‘Time 
Series  Dialog’  window.  To  display  time-series  of  another  location,  simply  click 
on  another  saved  location  asterisk  with  the  middle  mouse  button  and  the  same 
window  displays  a  time-series  of  the  selected  location. 


2. 2.6.2. 2  Co-tidal  Analysis 

The  steps  to  display  cotidal  analyses  of  the  region  are: 

1.  Click  on  the  ‘Cotidal  Analysis’  toggle  button  under  the  ‘Graphics’  pull  down 
menu.  This  pops  up  a  ‘Cotidal  Analysis  Dialog’  window  (Figure  30). 

2.  The  co-amplitude  and  co-phase  of  the  ‘Sea  Surface  Height’  (SSH)  is  displayed  in 
the  main  window.  The  co-amplitude  is  displayed  in  color  filled  contours  and  the 
co-phase  is  overlaid  in  isoline  contours. 

3.  To  display  the  cotidal  analyses  of  other  parameters,  such  as  the  U  component  and 
V  component  of  the  current  velocity,  select  the  desired  radio  button  on  the 
‘Cotidal  Analysis  Dialog’  window  and  click  on  the  ‘Apply’  button. 
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Figure  29  -  The  time-series  pop-up  window  in  the  Post-Processor 
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Figure  30  -  The  co-tidal  analysis  window  in  the  Post-Processor 
2.2.6.23  Snap  Shots! Animations 

The  followings  steps  are  required  for  viewing  snap  shots  and  animations  of 
SSH  and  current  velocity: 
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1.  Click  on  the  ‘Snap  Shot/ Animation’  button  on  the  Graphics  pull  down  menu. 
This  generates  a  ‘Snap  Shot/ Animation  Dialog’  window  (Figure  31)  and  displays 
the  SSH  in  color  filled  contours  in  the  main  window  (Figure  32). 

2.  The  SSH  is  overlaid  with  velocity  vector  arrows  the  size  of  which  varies  with 
magnitude. 

3.  To  display  snap  shots  of  SSH  data  overlaid  with  velocity  vectors  of  another  time 
frame,  select  an  appropriate  time  from  the  ‘Start  time’  text  box  in  the  ‘Snap 
Shot/ Animation  Dialog’  window  and  click  on  the  ‘Snap  Shot’  button. 

4.  To  animate  several  snap  shots,  select  a  time  from  the  ‘End  time’  text  box  in  the 
‘Snap  Shot/ Animation  Dialog’  window  and  the  time  steps  using  the  ‘Step’  slider 
bar. 

5.  Click  on  the  ‘Animate’  button  to  animate  the  snapshots  sequentially. 

The  user  can  manipulate  the  speed  and  direction  of  the  animation  as  well  as 
use  other  features  such  as  pause  and  oscillate  using  the  keyboard.  The  cursor  must 
be  in  the  animation  window  when  the  user  types  in  the  keyboard  commands.  It  must 
be  noted  that  it  takes  several  minutes  for  the  animation  window  to  pop  up,  and 
depending  on  the  processor  speed  and  number  of  frames  to  animate,  several  minutes 
for  the  animation  to  stabilize.  Only  then  should  any  attempts  be  made  to  control  it 
using  the  keyboard.  The  keys  used  to  control  the  animation  are  as  follows. 

Keyboard  control: 


n  -  go  1  frame  forward 
b  -  go  1  frame  backward 
s  -  go  to  the  starting  frame 
1  -  go  to  the  last  frame 


f  -  loop  forward 
r  -  loop  backward 
o  -  oscillate 
p  -  pause 


d  -  decrease  speed 
i  -  increase  speed 
q  -  quit 
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Figure  31  -  The  snap-shot/animation  dialog  window  in  the  Post-Processor 
22.6.2.4  Tidal  Event  Log 

To  view  the  tidal  event  log: 

1.  Click  on  the  ‘Tidal  Event  Log’  toggle  button  in  the  Graphics  pull  down  menu. 
This  generates  the  ‘Tidal  Event  Log  Dialog’  pop-up  window  (Figure  33). 

2.  The  bathymetry  is  displayed  again  in  the  main  Post-Processor  window  with  the 
yellow  asterisks  marking  the  saved  locations  (Figure  28). 

3.  Select  the  range  over  which  to  generate  a  tidal  event  log  using  the  ‘Start  time’  and 
‘End  time’  boxes  in  the  ‘Tidal  Event  Log  Dialog’  window. 

4.  Click  on  the  yellow  asterisk  marking  the  selected  saved  location  with  the  middle 
mouse  button. 

5.  This  pops  up  the  ‘Tidal  Event  Log’  main  window  (Figure  34).  The  red  line 
denotes  SSH  and  the  green  line  velocity  magnitude.  The  log  in  the  lower  text  box 
of  the  window  has  time  in  Julian  day,  elevation  in  meters,  velocity  in  cm/s  and 
direction  in  degrees. 
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Figure  32  -  Snap  shot  from  the  Post-Processor 
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Figure  33  -  Tidal  event  log  dialog  in  the  Post-Processor 
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Figure  34  -  Tidal  event  log  pop-up  window  in  the  Post-Processor 
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3.0  Error  Messages 


Some  of  the  user  error  messages  and  descriptions  are  provided  below.  The 
messages  usually  appear  in  the  ’Remark’  box  of  the  module  GUIs.  If  there  are  any 
other  problems  with  the  RME  that  the  System  Administrator  cannot  fix,  contact 
(228)  688-42 18(tel);  (228)  688-7100(fax)  or  email:  corbin@cast.msstate.edu. 

3.1  Grid  Generator  Module 

‘Min  Ion  must  be  smaller  than  max  Ion V  -  This  error  is  displayed  when  the  user  puts 
in  a  larger  value  for  the  Min  Ion  than  Max  Ion  in  the  region  coordinates  text  box. 

'Min  lat  must  be  smaller  than  max  lat!’  -  Same  as  above  for  latitude. 

'Select  Bathymetry  first!'  -  Displayed  when  the  user  tries  to  save  a  region  without 
selecting  bathymetry  database. 

‘Select  Station  data  first V  -  Displayed  when  the  user  tries  to  save  a  region  without 
selecting  a  station  database  file. 

‘A  coarse  grid  must  be  selected  for  nesting!’  -  Displayed  when  the  user  tries  to  nest  a 
region  inside  the  world  map  without  selecting  a  saved  region  as  a  regular  grid  first. 

‘A  fine  grid  has  been  created  for  this  coarse  grid!’  -  Displayed  when  the  user 
attempts  to  create  two  nests  for  the  same  regular  grid. 

‘Cannot  create  a  fine  grid  inside  a  fine  grid!’  -  Displayed  when  the  user  selects  a 
nested  grid  and  tries  to  nest  a  region  in  it. 

‘A  nested  grid  resolution  fraction  must  be  selected!’  -  Displayed  when  the  user  tries 
to  save  a  nested  grid  without  selecting  a  nested  grid  fraction. 

‘X  resolution  is  invalid!’  -  Displayed  when  the  user  types  in  an  invalid  grid  resolution 
in  the  X  resolution  box  or  leaves  it  empty. 
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'Y  resolution  is  invalid!’  -  Displayed  when  the  user  types  in  an  invalid  grid  resolution 
in  the  Y  resolution  box  or  leaves  it  empty. 

‘ Region  'region  name '  has  already  been  defined!’  -  Displayed  when  the  user  tries  to 
reuse  a  region  name  while  saving. 

‘Cannot  open  database  /..path/regionDB!’  -  Displayed  when  the  region  database 
information  file  for  the  user  in  the  directory  ‘usemame_db’  is  missing. 

‘ Cannot  open  database  L.path/bathyDB !’  -  Displayed  when  the  bathymetry  database 
information  file  for  the  user  in  the  directory  ‘usemame_db’  is  missing. 

‘ Cannot  overwrite  database  path/regionDB!’  -  Displayed  when  the  user  does  not 
have  write  permissions  for  the  ‘regionDB’  file  or  the  directory. 

‘Error  writing  to  /.. path/regionDB!’  -  Similar  to  the  previous  error  message,  when 
the  ‘regionDB’  file  has  been  moved. 

‘Select  a  region  to  delete!’  -  Displayed  when  the  user  has  not  selected  a  region  from 
the  ‘Defined  Grids’  box  and  presses  the  ‘delete’  button. 


3.2  Pre-Processor 

‘Fail  to  do  window  dump  using  xtof!’  -  Displayed  when  the  user  tries  to  save  the 
image  in  the  preprocessor  but  the  ‘xtof’  command  cannot  be  executed. 

‘Error  writing  stn  file!’  -  Displayed  when  the  user  tries  to  save  the  station  file  and 
does  not  have  write  permissions  in  the  ‘regions’  directory. 

‘Error  ingesting  domain  file!  (global/ desai  data)’  -  Displayed  when  the  boundary 
condition  netCDF  files  are  not  in  the  right  format. 

‘ /... path/ RME/ data/ Filename  does  not  exist!’  -  Displayed  when  the  boundary 
condition  files  do  not  exist  or  are  in  the  wrong  directory. 

Error!  Output  file  not  created!’  -  Displayed  when  the  user  tries  to  save  boundary 
conditions  for  a  location  but  does  not  have  write  permissions  to  the 
7 ..path/usemame_db/regions/regionname/’  directory. 
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‘Editing  stations !  Can't  edit  bathymetry!’  -  Displayed  when  the  user  presses  the  ‘edit 
bathymetry’  button  without  dismissing  the  ‘Station  Edit  Dialog’  window. 

‘Editing  boundary  conditions!  Can't  edit  bathymetry!’  -  Displayed  when  the  user 
presses  the  ‘edit  bathymetry’  button  without  dismissing  the  ‘Boundary  Edit  Dialog’ 
window. 

‘ Editing  bathymetry!  Can't  edit  stations!’  -  Displayed  when  the  user  presses  the  ‘edit 
stations’  button  without  dismissing  the  ‘Bathymetry  Edit  Dialog’  window. 

‘ Editing  boundary  conditions!  Can't  edit  stations!’  -  Displayed  when  the  user  presses 
the  ‘edit  stations’  button  without  dismissing  the  ‘Boundary  Edit  Dialog’  window. 

‘Editing  bathymetry!  Can't  edit  boundary  conditions !’  -  Displayed  when  the  user 
presses  the  ‘edit  boundary  conditions’  button  without  dismissing  the  ‘Bathymetry 
Edit  Dialog’  window. 

‘Editing  stations!  Can't  edit  boundary  conditions !’  -  Displayed  when  the  user  presses 
the  ‘edit  boundary  conditions’  button  without  dismissing  the  ‘Station  Edit  Dialog’ 
window. 

‘Cannot  undo  edit!’  -  Displayed  when  the  particular  editing  routine  has  already  been 
saved  and  the  buffer  cannot  revert  to  the  older  version  from  the  file. 

‘Overlay  stations  first  before  editing !’  -  Displayed  when  the  user  presses  the  ‘edit 
stations’  button  without  overlaying  stations  first. 

‘No  station  data!’  -  Displayed  when  the  station  file  has  not  been  properly  saved  using 
the  grid  generator  or  has  been  removed. 

‘Specify  a  direction  first!’  -  Displayed  when  the  user  has  not  selected  a  direction  in 
the  ‘Boundary  Edit  Dialog’  box  and  tries  to  edit  a  boundary. 

‘Specify  a  data  source  first!’  -  Displayed  when  the  user  has  not  selected  a  data  source 
for  the  boundary  conditions  in  the  ‘Boundary  Edit  Dialog’  box  and  tries  to  edit  a 
boundary. 

‘No  begin  station  index V  -  Displayed  when  the  station  index  is  missing. 
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3.3  Model  Packager 


Since  this  is  a  GUI-less  interface  there  is  no  inherent  error  display  provided. 
All  errors  are  UNIX  related  and  are  on  the  window  from  which  RME  was  run.  Most 
errors  stem  from  absence  of  files,  wrong  pathnames  and  read/ write  permissions. 

Some  common  errors  are  given  below: 

i.  Cannot  access  file:  No  such  file  or  directory 

ii.  cp:  file:  Permission  denied 

iii.  mv:  file:  Permission  denied 

iv.  tar:  file.tar:  Permission  denied 


3.4  Remote/Local  Execution 

All  errors  in  these  packages  are  displayed  in  the  ‘Model  Run  Status’  window 
(Figure  27).  They  are  mostly  model  run  errors  or  are  ‘ftp’  and  ‘telnet’  related  for 
‘remote  execution’.  Some  common  errors  are: 

ulO  file  not  created  -  Displayed  when  the  runtime  parameters  are  not  correctly 
specified  or  the  user  does  not  have  write  permission  for  the  directory  in  which  the 
‘..2dul0’  file  is  being  created. 

‘Invalid  command ’  -  PERL  interpreter  not  available  or  the  wrong  shell  is  being  used. 

hostname  invalid  or  cannot  be  reached’  -  Displayed  when  the  hostname  specified  by 
the  user  is  wrong  or  the  network  is  down. 

invalid  filename’  -  Displayed  when  a  filename  is  different  than  what  the  model 
expects. 

invalid  directory  -  Displayed  when  the  directory  path  is  invalid. 

3.5  Post-Processor 

Cannot  malloc  for  file  name!’  —  Memory  allocation  error. 
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‘No  bathy  file  u40.nc  in  input  directory!’  -  Displayed  when  the  bathymetry  netCDF 
file  has  been  removed  after  packaging  from  the  ‘..path/regions/regionname/’ 
directory. 

‘ Cannot  read  bathy  u40.nc  data!’  -  No  read  permissions  for  the  bathymetry  netCDF 
file. 

‘No  cotidal  analysis  file  cot2d.nc  in  input  directory!’  -  The  cotidal  netCDF  file  was 
not  created.  Either  the  model  did  not  produce  the  cotidal  analysis  file,  or  the  filter 
was  unable  to  convert  it  to  a  format  recognized  by  the  Post-Processor  module. 

‘Error  malloc  for  movie  data!’  -  Memory  allocation  error. 

‘Draw  a  contour  first!’  -  Displayed  when  the  user  tries  to  overlay  anything  without 
the  main  window  displaying  contours. 

‘Fail  to  do  window  dump  using  xtof!’  -  Displayed  when  the  user  tries  to  save  the 
image  in  the  Post-Processor  but  the  ‘xtof’  command  cannot  be  executed. 

‘No  station  data!’  -  Displayed  when  the  station  file  has  not  been  properly  saved  using 
the  grid  generator  or  has  been  removed. 

‘No  time  series  file  in  input  directory!’  -  The  time-series  netCDF  file  (tsr2d.nc)  was 
not  created.  Either  the  model  did  not  produce  the  time-series  files  as  no  locations 
were  saved  by  the  user,  or  the  filter  was  unable  to  convert  it  to  a  format  recognized 
by  the  Post-Processor  module. 

‘ Error  malloc  for  time  series  dim V  -  Memory  allocation  error. 

‘No  movie  file  mov2d.nc  in  input  directory!’  -  The  movie  netCDF  file  (mov2d.nc) 
was  not  created.  Either  the  model  did  not  produce  the  movie  file,  or  the  filter  was 
unable  to  convert  it  to  a  format  recognized  by  the  Post-Processor  module. 

‘ Error  malloc  for  movie  dim!’  -  Memory  allocation  error. 

‘ Fail  to  animate  using  x a!’  -  There  was  a  failure  to  create  animation  of  the  snapshots 
from  the  movie  file. 
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4.0  NOTES 


4.1  System  Considerations 


RME  is  intended  for  installation  in  and  execution  by  Silicon  Graphics, 
Incorporated  computing  platforms.  Installation  is  site  specific  and  tailored  to  the 
environment.  Appendix  D  provides  information  specific  to  installation  of  the  RME. 
While  the  RME  may  be  executed  from  an  X-terminal,  some  graphical  screens 
produced  by  RME  are  memory  intensive  and  may  cause  termination  of  the  software 
if  the  memory  of  the  X-terminal  is  insufficient.  The  RME  may  also  be  executed 
remotely  from  other  X-Windows  environments  such  Sun  Microsystems  and  LINUX 
by  changing  appropriate  display  settings.  However  the  graphics  may  sometime 
exceed  monitor  dimensions  due  to  varying  screen  resolutions  of  different  systems. 

4.2  System/Software  Requirements 


RME  is  an  integrated  software  system  that  requires  the  use  of  some 
commercial  software. 

RME  was  designed  for  execution  under  control  of  the  UNIX  operating  system 
on  Silicon  Graphics  hardware. 

RME  requires  the  X-Windows  environment 

The  Open  Software  Foundation’s  (OSF)  Motif  Toolkit  (library)  must  be  used 
and  be  available  in  the  execution  environment. 

A  routine  version  of  NCAR  Graphics  software  package  must  be  installed  on 
the  system  and  be  available  in  the  execution  environment  to  support  RME 
graphical  display  options. 

A  PERL5  interpreter  must  be  used  in  the  execution  environment. 

RME  is  an  interactive  application.  It  supports  all  standard  X-Windows  mouse 
and  keyboard  functions. 
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The  software  code  for  this  version  of  RME  was  compiled  using  C,  C++,  and 
FORTRAN  Compilers. 


4.3  Directory  Map 

RME  software  executables  have  been  designed  to  execute  using  directory 
paths  defined  via  UNIX  environmental  parameters  and  path  names  defined  within 
user  ‘login’  or  ‘cshrc’  or  ‘profile’  files.  These  parameters  must  be  determined  during 
installation  since  they  are  system  dependent.  A  complete  directory  tree  structure  of 
the  RME  is  provided  in  Appendix  E. 


4.4  Security 

The  RME  neither  supports  nor  restricts  the  overall  classification  of  the 
computing  environment.  The  restrictions  imposed  on  databases  of  individual  users 
are  left  to  the  system  administrator  of  the  machine  on  which  the  RME  is  installed. 
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APPENDIX  A 


Glossary  of  Terms 

’ 


Bathymetry  -  Pertaining  to  depth  of  ocean. 

Button  -  When  used  in  relation  to  the  mouse  device,  a  button  is  one  of  three 
pressure  switches,  which  may  be  pressed/clicked  to  control  some  feature  of  the 
screen  display.  When  used  in  relation  to  the  monitor  display,  a  button  is  a  labeled 
area  of  the  on-screen-graphical  design  that  resembles  a  switch,  which  can  be  made 
active  by  positioning  cursor  with  mouse  and  clicking. 

Click  -  The  act  of  pressing  a  button  on  a  mouse.  The  term  ‘click  on  ‘,  or  simply 
‘click’,  is  frequently  used  to  indicate  that  the  user  should  maneuver  the  mouse  cursor 
to  a  specified  location  on  the  screen  (usually  an  area  designed  to  resemble  a  button) 
and  controlled  from  the  keyboard,  press  (click)  the  appropriate  button  on  the  mouse. 

Cursor  -  A  graphical  symbol  that  identifies  a  portion  on  a  computer  monitor  screen. 
A  cursor  is  sometimes  controlled  by  moving  a  mouse  device.  Otherwise,  it  is 
controlled  from  the  keyboard,  usually  with  the  arrow  keys. 

Display  -  Synonymous  with  the  computer  monitor  screen;  also,  to  demonstrate  or  to 
show. 

Drag  -  The  act  of  pressing  and  holding  a  button  on  the  mouse  device  and  moving  the 
mouse  to  control  a  cursor's  position  on  the  monitor  screen.  The  purpose  of  dragging 
the  mouse  is  to  define  an  area  on  the  screen  or  to  move  a  graphical  object  to  another 
location. 

Graphical  User  Interface  (GUI)  -  RME  module  responsible  for  interfacing  with  the 
user  and  controlling  the  functionality  of  the  main  RME  display. 

Julian  -  The  day  of  the  year  according  to  the  Julian  calendar  which  begins  on  the 
first  day  of  the  year  (January  1).  A  Julian  date  does  not  include  a  year  as  part  of  its 
simple  format  (see  Appendix  G). 
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List  -  A  simple  series  of  words  or  numerals. 


Listbox  -  An  outlined  area  of  the  display  which  contains  a  list  of  textual  information. 
Selection  of  text  within  a  list  is  accomplished  by  placing  the  mouse  cursor  over  the 
appropriate  entry  and  clicking  a  button  on  the  mouse. 

Mouse  -  A  hand  controlled  device  used  to  interact  with  images  displayed  on  the 
computer  monitor  screen.  When  a  mouse  is  moved,  a  cursor  on  the  screen  moves  in 
the  same  direction  as  the  mouse.  One  or  more  buttons  may  be  present  on  a  mouse  for 
invoking  an  action  on  screen  at  the  corresponding  cursor  position. 

Profile  -  A  sequential  listing  of  parameters  keyed  to  a  reference  structure.  A 
bathymetric  profile  contains  sequential  depth/parameter  groups. 

Pull-Down  Menu  -  A  listing  of  procedural  options  that  appears  in  response  to 
activation  of  an  appropriately  labeled  (visible)  button  referred  to  as  the  menu  header. 
Options  are  selected  by  clicking  on  the  menu  header  to  display  the  options,  followed 
by  clicking  the  button  labeled  to  indicate  the  desired  option. 


Radio  Button  -  A  clickable  button  to  either  select  or  de-select  an  option. 

Rubber-band  -  The  act  of  dragging  the  mouse  to  define  an  area  on  the  screen.  A 
mouse  button  is  pressed  and  held  while  the  mouse  is  maneuvered  to  position  the  on¬ 
screen  cursor  at  a  desired  final  position;  then,  the  mouse  button  is  released. 

Screen  -  The  display  surface  of  a  computer  video  monitor  where  images  appear. 

Scroll  Bar  -  The  graphical  image  of  a  narrow  bar  with  arrows  embedded  at  both  ends 
and,  optionally,  a  movable  (sliding)  button  between  them.  The  scroll  bar  is  used  to 
position  a  portion  of  an  image  or  text  for  viewing  inside  a  bound  area  that  is  smaller 
than  the  whole  image  or  text.  Scrolling  is  accomplished  by  placing  the  mouse  cursor 
on  one  of  the  arrows  and  pressing  the  mouse  button.  Scrolling  may  also  be 
accomplished  by  placing  the  mouse  cursor  over  the  sliding  button  (if  present)  and 

dragging  the  sliding  button  to  a  new  position  along  the  bar. 

Slider  Bar  -  Similar  to  a  scroll  bar  but  does  not  have  arrows  embedded  on  ends. 
Instead  has  a  siding  button  which  can  be  manipulated  with  the  mouse. 

Tar  -  A  UNIX  command  to  archive  files  in  a  single  file  or  tape  for  back  up  and 
transport  purposes.  Also  used  to  describe  such  archiving  (‘tarring’,  ‘tarred’,  etc.). 
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Textbox  -  An  outlined  area  of  the  display  that  contains  textual  information.  Text  in  a 
textbox  may  sometimes  be  edited;  however,  the  usual  purpose  of  a  textbox  is  to 
provide  information  to  the  user. 

Untar  -  Extracting  files  from  a  ‘tarred’  archive  (see  tar). 

Unzoom  -  The  graphical  scaling  process  whereby  a  screen  display  item  is  reduced  in 
size  (also  see  Zoom). 

Widget  -  A  graphical  device  capable  of  receiving  input  from  the  keyboard  and  the 
mouse  and  communicating  with  an  application  or  another  widget  by  means  of  a 
callback.  Every  widget  is  a  member  of  only  one  class  and  always  has  a  window 
associated  with  it. ’(from:  OSF/Motif  Programmer's  Guide  ,  Rev.  1.1  Open  Software 
Foundation,  Prentice  Hall,  Englewood  Cliffs,  NJ,  1991,  p.  GL-13.) 

Window  -  An  outlined  area  of  the  screen  whose  contents  are  confined  to  the  outlined 
boundary  and  controlled  by  user  interaction  (with  buttons,  menus,  etc.).  A  window  is 
usually  a  top-level  structure  closely  tied  to  the  operating  environment  of  the 
computer. 

Zoom  -  The  graphical  scaling  process  whereby  a  screen  display  item  is  enlarged  in 
size  (also  see  Unzoom). 
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APPENDIX  B 
Abbreviations  Used 


ASCII 

American  Standard  Code  for  Information  Interchange 

Bathy 

Bathymetry 

Bdry 

Boundary 

CAST 

Center  for  Air  Sea  Technology 

CFL 

Courant-Frederich-Lewy  condition 

CURReNTSS 

Colorado  University  Rapidly  Relocatable  Nestable  Tidal  Storm 
Surge  Model 

DB/db 

Database 

DOD 

Department  of  Defense 

EDGE 

Extensible  Distributed  Graphical  Environment 

ftp 

File  transfer  protocol 

GUI 

Graphical  User  Interface 

IM 

Number  of  grid  points  in  the  model  domain  in  the  east-west(X) 
direction 

JM 

Number  of  grid  points  in  the  model  domain  in  the  north-south(Y) 
direction 

Lat 

Latitude 

LLT 

Latitude  Longitude  and  Time 
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Lon 

Max 

Min 

MSU 

ONR 

OSF 

RME 

SGI 

SSH 

Stn 

2- D 

3- D 


Longitude 

Maximum 

Minimum 

Mississippi  State  University 
Office  of  Naval  Research 
Open  Software  Foundation 
Relocatable  Modeling  Environment 
Silicon  Graphics  Incorporated 
Sea  Surface  Height 
Station 

Two-Dimensional 

Three-Dimensional 
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APPENDIX  C 


RME  Database  Configuration  System 


Most  of  the  databases  used  in  the  RME  are  stored  under  a  ‘username  db' 

dlreCSICh  ‘S  Created  under  1116  v-Path/RME/ime_db’  directory  when  the  user 
uses  RME  for  the  first  time.  Three  directories,  ‘bathy’,  ‘station’  and  ‘regions’  are 

"  “nder  ‘usemame_db’.  The  ‘bathy’  directory  contains  a  link  to  the  ET0P05 
global  bathymetric  data  stored  under  the  ‘/..path/RME/rme_db/defaults/bathy’ 
directory  and  the  station’  directory  contains  a  link  to  the  ‘tidal_stn.dat’  file  in  the 
.Vdefaults/station’  directory.  Information  on  the  bathymetry  datafiles  in  the  ‘bathy’ 
directory  is  stored  m  a  file  named  ‘bathyDB’  under  the  ‘usemame_db’  directed 
ny  new  additions  that  the  user  chooses  to  make  to  the  bathymetry  database  will  be 
m  the  yusemame.db/bathy’  directory  and  has  to  be  in  the  ‘lon-lat-bathy’  format 

“e“»ew  ba,hymetiy  database  must  •»  updated  ^  » 

Filename  Min.  Lon  Min.  Lat.  Max.  Lon.  Max.  Lat.  No.  of  lines 

Eg.  ysc2dsnd  117.625  24.6334  129.292  40.9667  17204 

Another  directory  called  ‘regions’  is  created  under  the  ‘username  db’ 
directory  when  the  user  stores  a  region  using  the  Grid  Generator.  Information  on  the 

ZtZlme  dh'edi  ‘Y  2,7  flle,called  regionDB  is  not  user  accessible.  A 
usemame_db  directory  is  created  under  the  ‘..path/RME/edge  db’  directory  which 

contains  links  to  the  ‘../path/RME/edge_db/rme_db’  directory  which  has  all  Se  * 

information  (icons,  executables,  etc.)  for  the  EDGE  environment. 
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APPENDIX  D 


RME  Installation  Procedures 


These  procedures  are  included  in  the  RME  package  in  a  file  named  ‘readme.txt’ 
under  the  main  ‘RME’  directory. 


1.0  System  Requirements 

SGI  workstation  operating  IRIX  6.2 
2.5  G  Bytes  of  hard  disk  space 


2.0  Installation  Procedures 

1.  Include  the  following  statement  in  the  ‘.cshrc’  file  if  you  are  using  C,  Z, 
or  T  shells.  Do  not  use  ksh,  bash,  or  bsh  shell  as  the  Remote/Local 
execution  modules  are  designed  to  work  on  ‘csh’  scripts  and  will  not 
work  in  these  shells. 

(a)  Insert  the  following  statement  after  all  setenv  commands: 

setenv  RMEPATH  pathname/RME 

(b)  Insert  the  following  statement  after  all  setpath  commands: 

setpath=($path  $RME_PATH) 

where  ‘pathname’  is  the  path  of  the  directory  containing  RME.tar.gz 

(ii)  Type  ‘source  .cshrc’ 

(iii)  Change  directory  to  the  directory  that  contains  RME.tar.gz 

(iv)  Unzip  and  extract  RME.tar.gz  by  typing: 
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‘gunzip  RME.tar.gzl  tar  xvf’ 

(v)  Install  RME  by  typing: 

‘Install  all’ 

(vi)  Start  RME  by  typing 

‘rme2d’ 

(vii)  Once  the  installation  is  complete,  test  each  module  to  ensure  they  work 
properly.  Report  any  problems  to  rme-developers @cast. msstate.edu. 
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APPENDIX  E 


RME  Directory  Structure 


Directory  Tree  Structure  Relevant  Description 


RME 

I _ Images 

I  I _ .icons 


1  1 

.xvpics 

1 _ 

_Movies 

1 _ 

_J)in 

1 _ 

_coastlines_db 

_data 

_edge_bin 

_edge_db 

1. 

_ default_db 

1. 

rme  db 

l. 

_ tides_db 

I. 

_ tmp 

_ 

_edge_profile 

1. 

_ root 

_ 

_edge_sys 

L 

_ apd 

L 

profile 

l_ 

_ scripts 

1 

_ sys__db 

1 

1  Images 

1 

1  1  .icons 

l 

1  1  work 

l 

1  1  1  .icons 

_edge_tmp 

_html 

jicl 

_profile_db 

_rme_db 

l_ 

_ defaults 

1  bathy 

1  station 

_rme_home 

l_ 

_ ImgTool 

1 _ imtl 

1 - jpeg 

1 _ tiff 

1  xpm 

1  1  lib 

l_ 

_ Mpp 

l_ 

_ NETTool 

1 _ CorbaClient 

1  Ilu 

l  I 

1  NETLib 

l  I 

1  NETLib2 

All  the  images  are  stored  in  this  directory 


The  coastline  database  is  stored  here 

The  boundary  conditions  from  the  Global  run  and  Desai-Wahr 
All  the  module  executable  go  here  for  execution  from  EDGE 
Personalised  edge  db  in  a  ‘usemame_db*  directory  are  created  here 

Initial  EDGE  db  copied  to  directory  <usemame_db* 


Personlized  profiles  for  users  created  in  username  directories 
Edge  system  codes  and  icons 


RME  database  personalized  user  db  created 
from  the  defaults  directory 


All  RME  source  code  stored  under  this  directory 


The  Motif  Plus  Plus  GUI  library 
Nettool  for  EDGE 


contd. 
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_ include 

L 

_ program 

1  cache 

1 _ cftp 

l _ egrgen 

1  grpicon2 

1 _ lshell 

1  runshell 

1 _ shell 

I  I _ UNIXTool 

I  I _ XTool 

I  I _ apd 

I  I _ boundary 

I  I _ cmap 

I  I _ coasMo 

I  I _ data 

I  I _ include 

I  I  1 _ bitmaps 

I  I _ lib 

i  I _ loc_exec 

I  I  I _ bin 

I  I  I _ dialog 

I  I  I  ! _ src 

I  I _ model 

I  I  I _ nested 

1  1  I _ reg 

i  I _ ncarg 

I  I  I _ bak 

I  I _ netcdf 

I  I _ rem_exec 


1  1 

_ bin 

1  l_ 

_ dialog 

1  1 

1  src 

_ parm 

1  src 

1 

filter 

I  1 _ src 

I  I _ splash 

I  I _ src 

I  I  I _ ColorClass 

I  I  I _ EdgeCommon 

I  I  I _ GridGen 

I  I  I _ ObjectManager 

I  I  I _ PostProcess 

I  I  I _ PreProcess 

I  I  I _ UserScale 

I  I  I _ ncl 

1  I  1 _ packager 

1  I _ stations 

1  I _ topbinfil 

I _ shell 


'i 


The  boundary  condition  extraction  program 


All  the  boundary  condition  data 
All  the  RME  header  files 

RME  library 

Local  execution  module 


Model  source  code  in  FORTRAN 


NCAR  graphics  code 

netCDF  read  write  routines  used  by  the  GUI 
Remote  execution  module 
Remote  execution  executables 


Common  main  programs  for  all  modules 
Grid  Generator  module 
EDGE  object  Manager 
Post-Processor  module 
Pre-Processor  module 


Model  Packager  module 
Station  extractor  module 
Bathymetry  gridding  module 
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APPENDIX  F 


Model  Parameters 


1 .  Runtime  Parameters  -  These  parameters  are  entered  by  the  user  in  the 

runtime  parameter  window  (See  Figure  26  and  Section  2.2.4. 1)  and  are  stored 
in  the  model  header  file  ‘...2dul0’. 


Parameter 

Window 

Name 

Model 

Variable 

Name 

Description 

Mode 

MODE 

If  Mode=2->2-D  calculation  is  performed 
Mode=3->3-D  prognostic  calculation  is  performed 
Mode=4->3-D  diagnostic  calculation  is  performed 

RStart 

RSTART 

Flag  for  restart  -  0  means  start  from  rest 

1  requires  sea2du70  file 

Days 

DAYS 

Number  of  Days  to  run  the  model 

RampUp 

RAMPUP 

Number  of  Days  over  which  the  model  is  ramped  up 

Date 

DATE 

Julian  day  the  model  run  is  started 

Year 

YEAR 

Year  of  the  model  run  (1975  or  later) 

Rstartlnt 

SAVEF 

Time  interval  in  days  at  which  the  restart  file  ..2dfld) 
is  saved 

SaveT 

SAVET 

Interval  at  which  to  save  the  ‘..ctl’  file 

Serlnt 

SAVES 

Interval  at  which  the  ‘..ser’  file  is  saved 

Movielnt 

SAVEM 

Interval  at  which  the  ‘movie’  file  ‘...2dmov’  is  saved 

PrintDlogl 

PRTD1 

Interval  in  which  to  write  to  standard  output 
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Parameter 

Window 

Name 

Model 

Variable 

Name 

Description 

PrintDlog2 

PRTD2 

Interval  in  which  data  is  written  to  standard  output 
later  in  the  model  run 

StartSer 

SWITCHS 

Day  at  which  to  start  ’ser’file 

DragCoeff 

CD 

Drag  coefficient  to  use  for  bottom  friction 
usually  0.0025 

HorEddy 

HORCON 

A  number  without  dimensions  used  in  calculating 
the  horiz.eddy  diffusivity  (0.0 1-0.1) 

AstroFlag 

ITIDE 

Flag  for  astronomical  forcing 

AstroDate 

STIDE 

Date  to  start  tidal  forcing 

StnAssm 

ITDASM 

Flag  to  assimilate  station  data 

Stnlnclusn 

IALL 

Flag  to  assimilate  all  stations 

FractN 

FRACTN 

Weight  to  be  given  to  data  assimilation 

DTA 

DTA 

Assimilation  time  step  (multiple  of  DTE) 

ISLV 

ISLV 

Used  in  sr  genCtlFile  call 

ISLASM 

ISLASM 

Used  in  sr  genCtlFile  call 

SSLV 

SSLV 

Used  in  sr  genCtlFile  call 

MinWDpth 

MINDEP 

Minimum  water  Depth 

ExtStep 

DTE 

External  Time  Step 

IntStep 

DTI 

Internal  Time  Step 

StartMovie 

SWITCHM  Day  to  start  the  movie  file 
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Parameter 

Model 

Description 

Window 

Variable 

Name 

Name 

HorKinVis 

AAA 

Const,  val  used  to  initialize  hor.  kin.  viscosity 
array  [m2  s'1] 

Iwind 

IWIND 

Flag  to  include  wind  forcing 

Iriver 

IRIVER 

Flag  to  include  river  forcing 

2.  Other  Model  Header  parameters  set  by  GUI  -  These  parameters  are  set  in 
the  header  file  Ogcml.h 


Model  Variable 
Name 

Description 

IM 

JM 

Number  of  grid  points  in  x  direction 

Number  of  grid  points  in  y  direction 

SEA 

Name  of  sea,  hardwired  to  ’coa’for  regular  and  fin’ 
for  nested  grids  in  RME 

SOUTH 

EAST 

NORTH 

WEST 

Flags  for  boundary  conditions 

ALATSW 

ALONSW 

Initial  origin  latitude 

Initial  origin  longitude 

DLON 

DLAT 

X  -  grid  resolution 

Y  -  grid  resolution 

NST 

IST(NST) 

JST(NST) 

Number  of  saved  locations 

X-direction  grid  position  array  for  the  saved  locations 
Y-direction  grid  position  array  for  the  saved  locations 
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APPENDIX  G 


Julian  Date  Calendar 


10  10 


11  li 


12  12 


13  13 


14  14 


15  15 


16  16 


17  17 


18  18 


19  19 


20  20 


21  21 


22  22 


23  23 


24  24 


25  25 


26  26 


27  27 


28  28 


29  29 


30  30 


31  31 


Feb  Mar 


32  60  I  91 


33  61  92 


34  1  62  93 


35  63  94 


36  64  95 


37  65  96 


38  66  97 


39  67  98 


40  68  99 


41  69  100 

42  70  101 

43  71  102 

44  72  103 

45  73  104 

46  74  105 

47  75  106 

48  76  107 

49  77  108 

50  78  109 

51  79  110 


52  80  111 


53  81  112 


54  82  113 


55  83  114 


56  84  115 


57  85  116 


58  86  117 


59  87  118 


88  1197 


89  I  120T 


90  I 


Mar 


121 


122 


123 


124 


125 


126 


127 


128 


129 


130 


131 


132 


133 


134 


135 


136 


137 


138 


139 


140 


141 


142 


143 


144 


145 


146 


147 


148 


149 


150 


151 


*For  Leap  Year,  this  number  will  be  60  and  add  one  to  the  rest.  Total  for  Leap  Year  is  366. 
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